All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class quicktime.app.display.FullScreenWindow

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----java.awt.Window
                           |
                           +----quicktime.app.display.FullScreenWindow

public class FullScreenWindow
extends Window
This class is provided for usage when the screen is put into full screen mode. The class manages a FullScreen object that will hide menu bars, task bars, etc. thus making available the entire screen for an application to use. The FullScreenWindow is the window which will fill that screen. As it is an extension of a java.awt.Window any usage of this window is congruous with the usage of a Window in Java applications.

See Also:
FullScreen

Variable Index

 o doNotify
This variable controls whether addNotify will actually call or fail - failing is silent.

Constructor Index

 o FullScreenWindow()
Creates a awt.Window for use in full screen mode.
 o FullScreenWindow(FullScreen)
Creates a awt.Window for use in full screen mode.
 o FullScreenWindow(FullScreen, Frame)
Creates a awt.Window for use in full screen mode.

Method Index

 o addNotify()
The addNotify method can only be successful in this class during or after the execution of the show method.
 o getFlags()
Returns the flags that will be used when the screen is placed in full screen mode with the show method.
 o getFullScreen()
This returns the FullScreen object that is used by the FullScreenWindow to place the screen into full screen mode when the show method is called, and to return the screen to normal mode when the hide method is called.
 o getGDevice()
Returns the device that corresponds to the screen that will be placed in full screen mode with the show method.
 o getInsets()
Returns insets of 0, 0, 0, 0 as a FullScreenWindow has no frame or border.
 o getPreferredSize()
This returns a previously set value of the requested size of the FullScreenWindow.
 o hide()
This method will return the specified screen to normal mode.
 o pack()
For a full screen window pack can only be called after the window has been shown.
 o setFlags(int)
Sets the flags that will be used when the screen is placed in full screen mode with the show method.
 o setGDevice(GDevice)
Sets the device that corresponds to the screen that will be placed in full screen mode with the show method.
 o setPreferredSize(int, int)
The application can set the requested size of the full screen when the screen is placed into full screen mode.
 o show()
This method is used to place the specified screen, at the specified resolution and flags, into full screen mode.

Variables

 o doNotify
 protected boolean doNotify
This variable controls whether addNotify will actually call or fail - failing is silent. The variable is set to true during the show method and is reset to false from the hide method which also calls removeNotify to remove the native restrictions imposed by incompatible functionality of native windowing usage in the Java VMs.

Constructors

 o FullScreenWindow
 public FullScreenWindow() throws QTException
Creates a awt.Window for use in full screen mode. It will create the FullScreen object which enables the screen to be placed into full screen mode

 o FullScreenWindow
 public FullScreenWindow(FullScreen fs) throws QTException
Creates a awt.Window for use in full screen mode. The application can pass in the FullScreen object which enables the screen to be placed into full screen mode.

Parameters:
fs - the QuickTime FullScreen object
 o FullScreenWindow
 public FullScreenWindow(FullScreen fs,
                         Frame f) throws QTException
Creates a awt.Window for use in full screen mode. The application can pass in the FullScreen object which enables the screen to be placed into full screen mode.

Parameters:
fs - the QuickTime FullScreen object
f - the Frame that owns the Window object.

Methods

 o getFullScreen
 public FullScreen getFullScreen()
This returns the FullScreen object that is used by the FullScreenWindow to place the screen into full screen mode when the show method is called, and to return the screen to normal mode when the hide method is called. Whilst the application can use this object for preflighting screen size no state is stored in the FullScreen object, so the application should interact directly with the methods of this, the FullScreenWindow, class.

Returns:
a FullScreen object
 o getPreferredSize
 public Dimension getPreferredSize()
This returns a previously set value of the requested size of the FullScreenWindow. It may return a width and height of 0, 0 if no previous size has been requested. In this case the current display size of the screen is used when the screen is placed into full screen mode.

Returns:
the currently requested size for full screen display
Overrides:
getPreferredSize in class Container
 o setPreferredSize
 public void setPreferredSize(int width,
                              int height)
The application can set the requested size of the full screen when the screen is placed into full screen mode. This method does not establish if the resolution requested is available, it will only request that size when the show method is called. To see if a requested size is available the application should get the FullScreen object from this class (getFullScreen) and call a preflightSize method. The result of the preflightSize method tells you the closest size that the desired screen can be placed in from your requested size.

Parameters:
width - the requested width or 0 to leave the screen at its current resolution when full screen mode is activated with the show method.
height - the requested height or 0 to leave the screen at its current resolution when full screen mode is activated with the show method.
 o getFlags
 public int getFlags()
Returns the flags that will be used when the screen is placed in full screen mode with the show method.

Returns:
the full screen flags
 o setFlags
 public void setFlags(int flags)
Sets the flags that will be used when the screen is placed in full screen mode with the show method.

Parameters:
flags - the full screen flags
 o setGDevice
 public void setGDevice(GDevice gDevice)
Sets the device that corresponds to the screen that will be placed in full screen mode with the show method.

Parameters:
gDevice - the gDevice of a screen of null to set the main screen
 o getGDevice
 public GDevice getGDevice()
Returns the device that corresponds to the screen that will be placed in full screen mode with the show method.

Returns:
the gDevice of a screen of null
 o show
 public void show()
This method is used to place the specified screen, at the specified resolution and flags, into full screen mode. It then resizes and positions the FullScreenWindow object so that the content region of this Window takes up the entire screen. It then shows the FullScreenWindow object. On both MacOS and Win32 there are no insets so the entire drawing surface from 0,0 to the width and height is available for display.

Due to the restrictions of the usage of addNotify() with this class, the pack() method is also called from this method (as is toFront). Thus the method does multiple things:

It is the Applications responsibility to hide this window when done as the user has no direct way to hide the window.

Overrides:
show in class Window
 o hide
 public void hide()
This method will return the specified screen to normal mode. It then hides the window.

Overrides:
hide in class Component
 o addNotify
 public void addNotify()
The addNotify method can only be successful in this class during or after the execution of the show method. The native Java VM's have peculiarities in windows positioning which are not compatible with the requirement of the FullScreenWindow's purpose to fill the entire screen. An application should never need to call this method directly - if it is called at an inappropriate time the call will silently fail.

Overrides:
addNotify in class Window
 o pack
 public void pack()
For a full screen window pack can only be called after the window has been shown. The FullScreenWindow.show call will call pack to ensure that the contained components are laid out correctly.

Overrides:
pack in class Window
 o getInsets
 public Insets getInsets()
Returns insets of 0, 0, 0, 0 as a FullScreenWindow has no frame or border.

Returns:
the insets of this container.
Overrides:
getInsets in class Container

All Packages  Class Hierarchy  This Package  Previous  Next  Index